Running Enchanting

Now that you've installed Enchanting, and, if you are using a source code version, built and prepared it, it is time to run Enchanting.

The Easy Way

End users will want to use this method most of the time.

Windows

• In the Enchanting directory, run Enchanting.exe.
• Your firewall may notice that EnchantingFE.exe wants to establish a network connection. It talks to the back end over a network socket on the local computer. Please allow it to do so.

Mac OS X

• In the Enchanting directory, run Enchanting.app.

Linux

• Sorry, you'll have to use the Verbose Way. (Can anyone help me figure out how to put a nice shortcut to start Enchanting on Linux?)

The Verbose Way

The verbose method shows you a window in which you can see what is going on in the Back End. End users may want to try this method if they have problems with the easy way. Developers may also appreciate this method.

Windows

• Run verbose_enchanting.windows.bat in the Enchanting folder.

Mac OS X

• Run verbose_enchanting.macosx.command in the Enchanting folder.

Linux

• Run verbose_enchanting.linux.sh.

The Developer Way

The previous methods start the back end and instruct it to start the front end. Sometimes in development you want to start them independantly.

Windows

• In a Command/DOS shell, change into the BackEnd directory and run 'run.bat' to start the back end.
• In Windows Explorer, go to the FrontEnd directory and run EnchantingFE.exe.

Mac OS X

• In a Terminal, change into the BackEnd directory and run './run' to start the back end.
• In a Finder window, go to the FrontEnd directory and run EnchantingFE.app.

Linux

• In a Terminal/Konsole/shell, change into the BackEnd directory and run './run' to start the back end.
• Start the front end by running enchanting_squeak_vm.

Notes:

• Developers may want to build and run the back end (perhaps by running './build && ./run')
• run/run.bat takes an optional parameter — a command to execute. This allows you to specify the command line to run the front end. The back end will launch the front end and terminate when the front end quits. For more details, look at the scripts used in the verbose method of running Enchanting.
• If you are running a source build, the front end will not automatically connect to the back end. You will need to choose "File -> New" or "File -> Open" from the menu, and, currently, a dialog will come up saying "Remote Sensors Enabled" to indicate that a connection can be made. If you can see what the back end is doing, it will indicate if that Enchanting is listening for messages when a connection is established.

---